Skip to content

feat: [AI-7392] humanize tool-call titles at the source#980

Open
ralphstodomingo wants to merge 2 commits into
mainfrom
feat/AI-7392-tool-title-labels
Open

feat: [AI-7392] humanize tool-call titles at the source#980
ralphstodomingo wants to merge 2 commits into
mainfrom
feat/AI-7392-tool-title-labels

Conversation

@ralphstodomingo

@ralphstodomingo ralphstodomingo commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

What

Tool calls now carry a readable, dbt-aware title at the source, so any client that renders state.title (the chat webview, TUI, future surfaces) shows a descriptive label without re-implementing the logic:

  • read models/customers.sql"Reading customers model"
  • glob **/*.sql → **"Searching /*.sql"
  • edit models/staging/stg_customers.sql"Editing stg_customers model"
  • non-file / rich-title tools (sql_analyze → "Analyze: 2 issues [high]", bash → its description) are unchanged.

How

  • src/altimate/tool-label.tsdescribeToolCall(tool, input, rawTitle). File-acting tools get a gerund verb + a friendly target; dbt naming (model/seed/macro/…) is applied only when the path sits under the matching directory, degrading to the plain filename off-dbt. Everything else returns the tool's own title.
  • src/tool/tool.ts — one line in the existing execute() wrapper rewrites result.title for every tool. No per-tool edits, so no upstream-merge surface.

Why here

This replaces client-side humanizing (previously prototyped in the chat webview) with a single source of truth in the harness, per review feedback. The chat webview (vscode-altimate-mcp-server) is being simplified to render state.title verbatim and depends on this.

Testing

  • bun test test/altimate/tool-label.test.ts — 6 cases (dbt naming, filename fallback, glob/grep/list, passthrough, no-path fallback).
  • E2E: built this branch's binary, ran it under altimate serve in code-server with the state.title-only webview — confirmed "Reading customers model" etc. render (the webview no longer humanizes, so the label can only come from here).

🤖 Generated with Claude Code


Summary by cubic

Humanizes tool-call titles at the source so clients can render state.title directly. Addresses Linear AI-7392 by making file-tool labels dbt-aware and readable (e.g., "Reading customers model").

  • New Features

    • Rewrites result.title in the Tool.execute() wrapper for consistent labels.
    • Adds describeToolCall(tool, input, rawTitle) in packages/opencode/src/altimate/tool-label.ts to humanize file tools (read, write, edit, multiedit, glob, grep, list) with dbt-aware targets; falls back to the filename off-dbt.
    • Adds tests in packages/opencode/test/altimate/tool-label.test.ts covering dbt naming, glob/grep/list, passthrough, and fallbacks; updates packages/opencode/test/tool/write.test.ts to expect "Writing " labels.
  • Migration

    • Clients should render state.title as-is and remove any custom title logic.

Written for commit 9e1853e. Summary will update on new commits.

Review in cubic

Summary by CodeRabbit

  • New Features

    • Tool actions now show clearer, human-friendly titles such as “Reading”, “Writing”, and “Searching” with simplified file targets.
    • Common dbt-related paths are displayed in a cleaner format, making model, seed, macro, snapshot, test, and analysis references easier to scan.
  • Bug Fixes

    • Non-file tools keep their existing titles.
    • File-based tools now fall back gracefully when no usable path is available.
    • Existing file names and extensions are preserved where appropriate.

Rewrite each tool's state.title in the execute() wrapper so any client
(chat webview, TUI, ...) can render a readable label straight from
state.title — e.g. "Reading customers model" for a dbt model read,
"Searching **/*.sql" for a glob. File-acting tools get a gerund verb
plus a dbt-aware target (model/seed/macro, degrading to the filename
off-dbt); every other tool keeps the rich title it already emits.
@ralphstodomingo ralphstodomingo self-assigned this Jul 1, 2026
@coderabbitai

coderabbitai Bot commented Jul 1, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Introduces a describeToolCall utility that generates dbt-aware, human-readable tool call titles from tool inputs, wires it into the tool execution wrapper to rewrite result titles post-execution, and adds/updates tests covering label formatting for various tools and dbt directory structures.

Changes

Tool label humanization

Layer / File(s) Summary
describeToolCall utility
packages/opencode/src/altimate/tool-label.ts
Adds verb/kind maps, helpers for string normalization and friendly target formatting (dbt directory-aware), file target extraction per tool type, and the exported describeToolCall() function returning humanized or fallback titles.
Execution wrapper wiring
packages/opencode/src/tool/tool.ts
Imports describeToolCall and rewrites result.title post-execute() using its output, falling back to the original title when undefined.
Tests
packages/opencode/test/altimate/tool-label.test.ts, packages/opencode/test/tool/write.test.ts
Adds a test suite validating dbt path labeling (models, macros, seeds, analyses), non-dbt fallback, glob/grep/list targets, rich-title tool passthrough, and no-path fallback; updates the write tool test to expect the new humanized title.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Caller
  participant ToolExecute as tool.ts execute()
  participant DescribeToolCall

  Caller->>ToolExecute: invoke tool (id, args)
  ToolExecute->>ToolExecute: run tool logic, produce result.title
  ToolExecute->>DescribeToolCall: describeToolCall(id, args, result.title)
  DescribeToolCall->>DescribeToolCall: build verb + friendly target (dbt-aware)
  DescribeToolCall-->>ToolExecute: humanized title or undefined
  ToolExecute->>ToolExecute: result.title = humanized ?? original title
  ToolExecute-->>Caller: return result
Loading

Poem

A rabbit hops through paths and files,
Turning code names into friendly smiles,
"models" become sleek little tales,
No more clunky path-based fails,
Hop, hop — humanized titles for miles! 🐇✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description covers the change and testing, but it does not follow the required template or include the required PINEAPPLE header. Rewrite it to start with PINEAPPLE and use the template sections: Summary, Test Plan, and Checklist, including the checklist items.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly describes the main change: humanizing tool-call titles at execution time.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/AI-7392-tool-title-labels

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install failed. For unrecoverable errors, disable the tool in CodeRabbit configuration.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ralphstodomingo

Copy link
Copy Markdown
Contributor Author

Paired chat-webview change (renders the humanized state.title from this PR): AltimateAI/vscode-altimate-mcp-server#388

The execute() wrapper now humanizes file-tool titles at the source, so
the write tool's title is "Writing <file>" rather than the raw relative
path. Update the assertion accordingly.
@ralphstodomingo ralphstodomingo marked this pull request as ready for review July 2, 2026 02:58
Copilot AI review requested due to automatic review settings July 2, 2026 02:58

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

Tip: disable this comment in your organization's Code Review settings.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
packages/opencode/test/altimate/tool-label.test.ts (1)

31-35: 🎯 Functional Correctness | 🔵 Trivial | ⚡ Quick win

Consider adding a case for list on a nested dbt subdirectory.

The existing case only covers a top-level directory ({ path: "models" }). A case like { path: "models/staging" } would have caught the mislabeling issue flagged in tool-label.ts (friendlyTarget applying the dbt "model" suffix to a directory name).

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/opencode/test/altimate/tool-label.test.ts` around lines 31 - 35, Add
a test in tool-label.test.ts for describeToolCall("list", ...) using a nested
dbt subdirectory target like models/staging, since the current list case only
covers the top-level models path and misses the friendlyTarget mislabeling in
tool-label.ts. Update the test set so it asserts the nested directory is labeled
correctly (without the dbt “model” suffix), keeping the existing glob/grep/list
coverage intact.
packages/opencode/src/altimate/tool-label.ts (1)

41-71: 🎯 Functional Correctness | 🔵 Trivial | ⚡ Quick win

list on a nested dbt subdirectory produces a misleading "model" label.

friendlyTarget strips extensions and appends the dbt "kind" noun whenever any ancestor segment matches DBT_DIR_KIND, regardless of whether the target is a file or a directory. This works fine for read/write/edit (always files) but for list the target is always a directory, so listing a nested dbt folder is mislabeled as if it were a single model:

  • describeToolCall("list", { path: "models" }, ...)"Listing models" (correct, top-level dir has no ancestor match)
  • describeToolCall("list", { path: "models/staging" }, ...)"Listing staging model" (wrong — this is a directory of many models, not one model)

Consider skipping the dbt kind-suffix rewrite for list, or only applying it when the base segment has a recognized dbt file extension (sql/yaml/csv).

💡 Possible fix
 function friendlyTarget(rawPath: string): string {
   const segments = rawPath.replace(/\\/g, "/").replace(/^\.\//, "").split("/").filter(Boolean)
   const base = segments[segments.length - 1] ?? rawPath
   for (const segment of segments.slice(0, -1)) {
     const kind = DBT_DIR_KIND[segment.toLowerCase()]
-    if (kind) {
+    if (kind && /\.(sql|ya?ml|csv)$/i.test(base)) {
       const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
       return `${name} ${kind}`
     }
   }
   return base
 }
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/opencode/src/altimate/tool-label.ts` around lines 41 - 71, The
`list` tool is incorrectly reusing `friendlyTarget`, which adds a dbt kind
suffix for any path with a dbt ancestor and makes directory listings like nested
folders look like a single model. Update `fileTarget` so the `list` branch does
not apply the file-oriented `friendlyTarget` rewrite, or make `friendlyTarget`
only append the dbt kind when the target is a file with a recognized dbt
extension. Keep the existing behavior for `read`/`write`/`edit`/`multiedit`, and
verify `describeToolCall("list", ...)` produces directory names without
misleading model labels.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@packages/opencode/src/altimate/tool-label.ts`:
- Around line 41-71: The `list` tool is incorrectly reusing `friendlyTarget`,
which adds a dbt kind suffix for any path with a dbt ancestor and makes
directory listings like nested folders look like a single model. Update
`fileTarget` so the `list` branch does not apply the file-oriented
`friendlyTarget` rewrite, or make `friendlyTarget` only append the dbt kind when
the target is a file with a recognized dbt extension. Keep the existing behavior
for `read`/`write`/`edit`/`multiedit`, and verify `describeToolCall("list",
...)` produces directory names without misleading model labels.

In `@packages/opencode/test/altimate/tool-label.test.ts`:
- Around line 31-35: Add a test in tool-label.test.ts for
describeToolCall("list", ...) using a nested dbt subdirectory target like
models/staging, since the current list case only covers the top-level models
path and misses the friendlyTarget mislabeling in tool-label.ts. Update the test
set so it asserts the nested directory is labeled correctly (without the dbt
“model” suffix), keeping the existing glob/grep/list coverage intact.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: d3e6e321-9dc3-4f33-9aca-1c5cc2a20592

📥 Commits

Reviewing files that changed from the base of the PR and between f0fb1e1 and 9e1853e.

📒 Files selected for processing (4)
  • packages/opencode/src/altimate/tool-label.ts
  • packages/opencode/src/tool/tool.ts
  • packages/opencode/test/altimate/tool-label.test.ts
  • packages/opencode/test/tool/write.test.ts

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR centralizes human-friendly tool-call titles in the tool execution layer so all clients can render state.title directly, with dbt-aware labels for file-acting tools.

Changes:

  • Adds describeToolCall() to generate readable, dbt-aware titles for file/path-oriented tools (read/write/edit/multiedit/glob/grep/list).
  • Rewrites result.title for every tool call inside the Tool.execute() wrapper to apply this labeling consistently.
  • Adds/updates Bun tests to validate title humanization behavior.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
packages/opencode/src/tool/tool.ts Applies centralized title humanization in the tool execute wrapper.
packages/opencode/src/altimate/tool-label.ts Introduces describeToolCall() and dbt-aware target formatting logic.
packages/opencode/test/altimate/tool-label.test.ts Adds unit tests for tool-call title labeling behavior.
packages/opencode/test/tool/write.test.ts Updates expectations to match the new humanized title format for write.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +46 to +57
function friendlyTarget(rawPath: string): string {
const segments = rawPath.replace(/\\/g, "/").replace(/^\.\//, "").split("/").filter(Boolean)
const base = segments[segments.length - 1] ?? rawPath
for (const segment of segments.slice(0, -1)) {
const kind = DBT_DIR_KIND[segment.toLowerCase()]
if (kind) {
const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
return `${name} ${kind}`
}
}
return base
}
Comment on lines +80 to +89
export function describeToolCall(tool: string, input: unknown, rawTitle?: string): string | undefined {
const fallback = asString(rawTitle)
const verb = FILE_TOOL_VERBS[tool]
if (verb && input && typeof input === "object") {
const target = fileTarget(tool, input as Record<string, unknown>)
if (target) return `${verb} ${target}`
}
// Non-file / rich-title tools: keep the title the tool already emitted.
return fallback
}
Comment on lines +348 to +350
// The execute() wrapper humanizes file-tool titles at the source
// (see src/altimate/tool-label.ts) — a non-dbt path degrades to the
// filename, so the title is a readable "Writing <file>" label.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found across 4 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/opencode/src/altimate/tool-label.ts">

<violation number="1" location="packages/opencode/src/altimate/tool-label.ts:50">
P3: Non-dbt files under common directories like `src/models` can be shown as dbt objects because `friendlyTarget()` applies the dbt noun to any path segment named `models`, `tests`, or `macros`, regardless of the target file type. That makes labels such as `Reading User.tsx model` possible outside dbt projects; consider only applying the dbt noun when the target looks like a dbt resource (for example known dbt file extensions) and otherwise falling back to the basename.</violation>

<violation number="2" location="packages/opencode/src/altimate/tool-label.ts:85">
P2: When `list` targets the worktree root (no path argument or empty relative path), `fileTarget()` returns `undefined` and `asString(rawTitle)` also returns `undefined` (since `path.relative(worktree, worktree)` is `""`). The `??` fallback in `tool.ts` then yields the original empty-string title, producing a blank UI label. Consider producing a fallback like `"Listing ."` when a file tool has a verb but neither a usable target nor a non-empty raw title.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

const verb = FILE_TOOL_VERBS[tool]
if (verb && input && typeof input === "object") {
const target = fileTarget(tool, input as Record<string, unknown>)
if (target) return `${verb} ${target}`

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: When list targets the worktree root (no path argument or empty relative path), fileTarget() returns undefined and asString(rawTitle) also returns undefined (since path.relative(worktree, worktree) is ""). The ?? fallback in tool.ts then yields the original empty-string title, producing a blank UI label. Consider producing a fallback like "Listing ." when a file tool has a verb but neither a usable target nor a non-empty raw title.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/opencode/src/altimate/tool-label.ts, line 85:

<comment>When `list` targets the worktree root (no path argument or empty relative path), `fileTarget()` returns `undefined` and `asString(rawTitle)` also returns `undefined` (since `path.relative(worktree, worktree)` is `""`). The `??` fallback in `tool.ts` then yields the original empty-string title, producing a blank UI label. Consider producing a fallback like `"Listing ."` when a file tool has a verb but neither a usable target nor a non-empty raw title.</comment>

<file context>
@@ -0,0 +1,89 @@
+  const verb = FILE_TOOL_VERBS[tool]
+  if (verb && input && typeof input === "object") {
+    const target = fileTarget(tool, input as Record<string, unknown>)
+    if (target) return `${verb} ${target}`
+  }
+  // Non-file / rich-title tools: keep the title the tool already emitted.
</file context>

const segments = rawPath.replace(/\\/g, "/").replace(/^\.\//, "").split("/").filter(Boolean)
const base = segments[segments.length - 1] ?? rawPath
for (const segment of segments.slice(0, -1)) {
const kind = DBT_DIR_KIND[segment.toLowerCase()]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: Non-dbt files under common directories like src/models can be shown as dbt objects because friendlyTarget() applies the dbt noun to any path segment named models, tests, or macros, regardless of the target file type. That makes labels such as Reading User.tsx model possible outside dbt projects; consider only applying the dbt noun when the target looks like a dbt resource (for example known dbt file extensions) and otherwise falling back to the basename.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/opencode/src/altimate/tool-label.ts, line 50:

<comment>Non-dbt files under common directories like `src/models` can be shown as dbt objects because `friendlyTarget()` applies the dbt noun to any path segment named `models`, `tests`, or `macros`, regardless of the target file type. That makes labels such as `Reading User.tsx model` possible outside dbt projects; consider only applying the dbt noun when the target looks like a dbt resource (for example known dbt file extensions) and otherwise falling back to the basename.</comment>

<file context>
@@ -0,0 +1,89 @@
+  const segments = rawPath.replace(/\\/g, "/").replace(/^\.\//, "").split("/").filter(Boolean)
+  const base = segments[segments.length - 1] ?? rawPath
+  for (const segment of segments.slice(0, -1)) {
+    const kind = DBT_DIR_KIND[segment.toLowerCase()]
+    if (kind) {
+      const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
</file context>

@dev-punia-altimate dev-punia-altimate left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 Code Review — OpenCodeReview (Gemini) — 3 finding(s)

  • 2 anchored to a line (posted inline when the comment stream is on)
  • 1 without a line anchor
All findings (full text)

1. packages/opencode/src/altimate/tool-label.ts (L49-L50)

[🟠 MEDIUM] Iterating left-to-right (from the root down) can incorrectly match an outer directory that coincidentally shares a name with a dbt folder, rather than the intended specific directory (e.g., an absolute path like /Users/user/models/my_project/macros/utils.sql would match models instead of macros, returning utils model instead of utils macro).

Consider iterating right-to-left (from the file upwards) to match the most specific parent directory.

Suggested change:

  for (let i = segments.length - 2; i >= 0; i--) {
    const segment = segments[i]
    const kind = DBT_DIR_KIND[segment.toLowerCase()]

2. packages/opencode/src/altimate/tool-label.ts (L51-L54)

[🟠 MEDIUM] The regex misses .py (for Python models) and .md (for dbt documentation files), which are both common in dbt projects. Without these, a Python model would render as model.py model rather than model model. Consider adding them to the regex.

Suggested change:

    if (kind) {
      const name = base.replace(/\.(sql|ya?ml|csv|py|md)$/i, "")
      return `${name} ${kind}`
    }

3. packages/opencode/src/altimate/tool-label.ts

[🔵 LOW] FILE_TOOL_VERBS and DBT_DIR_KIND are plain objects. Looking up a string like constructor or toString could hit inherited Object.prototype properties, leading to unexpected string values in the label.

Consider using Object.assign(Object.create(null), {...}) to safely initialize these dictionaries without prototypes.

Suggested change:

const FILE_TOOL_VERBS: Record<string, string> = Object.assign(Object.create(null), {
  read: "Reading",
  write: "Writing",
  edit: "Editing",
  multiedit: "Editing",
  glob: "Searching",
  grep: "Searching",
  list: "Listing",
})

/** dbt directory → singular noun used in the label. */
const DBT_DIR_KIND: Record<string, string> = Object.assign(Object.create(null), {
  models: "model",
  seeds: "seed",
  macros: "macro",
  snapshots: "snapshot",
  tests: "test",
  analyses: "analysis",
  analysis: "analysis",
})

Comment on lines +49 to +50
for (const segment of segments.slice(0, -1)) {
const kind = DBT_DIR_KIND[segment.toLowerCase()]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[🟠 MEDIUM] Iterating left-to-right (from the root down) can incorrectly match an outer directory that coincidentally shares a name with a dbt folder, rather than the intended specific directory (e.g., an absolute path like /Users/user/models/my_project/macros/utils.sql would match models instead of macros, returning utils model instead of utils macro).

Consider iterating right-to-left (from the file upwards) to match the most specific parent directory.

Suggested change:

Suggested change
for (const segment of segments.slice(0, -1)) {
const kind = DBT_DIR_KIND[segment.toLowerCase()]
for (let i = segments.length - 2; i >= 0; i--) {
const segment = segments[i]
const kind = DBT_DIR_KIND[segment.toLowerCase()]

Comment on lines +51 to +54
if (kind) {
const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
return `${name} ${kind}`
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[🟠 MEDIUM] The regex misses .py (for Python models) and .md (for dbt documentation files), which are both common in dbt projects. Without these, a Python model would render as model.py model rather than model model. Consider adding them to the regex.

Suggested change:

Suggested change
if (kind) {
const name = base.replace(/\.(sql|ya?ml|csv)$/i, "")
return `${name} ${kind}`
}
if (kind) {
const name = base.replace(/\.(sql|ya?ml|csv|py|md)$/i, "")
return `${name} ${kind}`
}

@dev-punia-altimate

Copy link
Copy Markdown
Contributor

🤖 Code Review — OpenCodeReview (Gemini) — 3 finding(s)

  • 2 anchored to a line (posted inline when the comment stream is on)
  • 1 without a line anchor
All findings (full text)

1. packages/opencode/src/altimate/tool-label.ts (L49-L50)

[🟠 MEDIUM] Iterating left-to-right (from the root down) can incorrectly match an outer directory that coincidentally shares a name with a dbt folder, rather than the intended specific directory (e.g., an absolute path like /Users/user/models/my_project/macros/utils.sql would match models instead of macros, returning utils model instead of utils macro).

Consider iterating right-to-left (from the file upwards) to match the most specific parent directory.

Suggested change:

  for (let i = segments.length - 2; i >= 0; i--) {
    const segment = segments[i]
    const kind = DBT_DIR_KIND[segment.toLowerCase()]

2. packages/opencode/src/altimate/tool-label.ts (L51-L54)

[🟠 MEDIUM] The regex misses .py (for Python models) and .md (for dbt documentation files), which are both common in dbt projects. Without these, a Python model would render as model.py model rather than model model. Consider adding them to the regex.

Suggested change:

    if (kind) {
      const name = base.replace(/\.(sql|ya?ml|csv|py|md)$/i, "")
      return `${name} ${kind}`
    }

3. packages/opencode/src/altimate/tool-label.ts

[🔵 LOW] FILE_TOOL_VERBS and DBT_DIR_KIND are plain objects. Looking up a string like constructor or toString could hit inherited Object.prototype properties, leading to unexpected string values in the label.

Consider using Object.assign(Object.create(null), {...}) to safely initialize these dictionaries without prototypes.

Suggested change:

const FILE_TOOL_VERBS: Record<string, string> = Object.assign(Object.create(null), {
  read: "Reading",
  write: "Writing",
  edit: "Editing",
  multiedit: "Editing",
  glob: "Searching",
  grep: "Searching",
  list: "Listing",
})

/** dbt directory → singular noun used in the label. */
const DBT_DIR_KIND: Record<string, string> = Object.assign(Object.create(null), {
  models: "model",
  seeds: "seed",
  macros: "macro",
  snapshots: "snapshot",
  tests: "test",
  analyses: "analysis",
  analysis: "analysis",
})

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants